home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / sesmgr.z / sesmgr
Encoding:
Text File  |  2002-10-03  |  21.0 KB  |  397 lines
  1.  
  2.  
  3.  
  4. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssseeeessssmmmmggggrrrr - Fibre Channel Drive Enclosure Status/Configuration Command Line
  10.      Interface
  11.  
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      The command line syntax of sssseeeessssmmmmggggrrrr takes multiple flavors depending on the
  15.      option.
  16.  
  17.      sssseeeessssmmmmggggrrrr ggggeeeettttvvvveeeerrrrssssiiiioooonnnn
  18.      sssseeeessssmmmmggggrrrr ppppoooollllllll
  19.      sssseeeessssmmmmggggrrrr ttttooooppppoooollllooooggggyyyy [----cccc _c_h_a_n_n_e_l-_I_D [----cccc _c_h_a_n_n_e_l-_I_D] . . .
  20.      sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss [----vvvv] [----cccc _c_h_a_n_n_e_l-_I_D] [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . .
  21.      sssseeeessssmmmmggggrrrr rrrreeeemmmmoooovvvveeee ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  22.      sssseeeessssmmmmggggrrrr lllleeeeddddoooonnnn ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  23.      sssseeeessssmmmmggggrrrr lllleeeeddddooooffffffff ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  24.      sssseeeessssmmmmggggrrrr bbbbyyyyppppaaaassssssss ----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B [----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B] . . .
  25.      sssseeeessssmmmmggggrrrr uuuunnnnbbbbyyyyppppaaaassssssss ----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B [----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B] . . .
  26.      sssseeeessssmmmmggggrrrr sssslllloooottttbbbbyyyyppppaaaassssssss ----eeee _e_n_c_l_o_s_u_r_e-_I_D ----ssss _s_l_o_t-_I_D ----pppp _A|_B [----eeee _e_n_c_l_o_s_u_r_e-_I_D ----ssss
  27.      _s_l_o_t-_I_D ----pppp _A|_B] . . .
  28.      sssseeeessssmmmmggggrrrr sssslllloooottttuuuunnnnbbbbyyyyppppaaaassssssss ----eeee _e_n_c_l_o_s_u_r_e-_I_D ----ssss _s_l_o_t-_I_D ----pppp _A|_B [----eeee _e_n_c_l_o_s_u_r_e-_I_D ----ssss
  29.      _s_l_o_t-_I_D ----pppp _A|_B] . . .
  30.      sssseeeessssmmmmggggrrrr iiiinnnnsssseeeerrrrtttt ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  31.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmoooonnnn ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  32.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmmmmmuuuutttteeee ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  33.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmooooffffffff ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  34.  
  35.  
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      The sesmgr command is a user front end to sssseeeessssddddaaaaeeeemmmmoooonnnn which collects status
  39.      of all supported fibre channel enclosures and allows for configuration
  40.      changes.
  41.  
  42.  
  43. CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  44.      ggggeeeettttvvvveeeerrrrssssiiiioooonnnn     This command will report the version level of sssseeeessssmmmmggggrrrr.
  45.  
  46.      ppppoooollllllll           This command will request that the daemon re-scan the SAN
  47.                     for its configuration and also update the status of all
  48.                     known devices.  Typically this should only need to be done
  49.                     if the SAN configuration is manually changed outside of
  50.                     the sesmgr command set.
  51.  
  52.      ttttooooppppoooollllooooggggyyyy       This command will print the daemon's understanding of the
  53.                     topology of the SAN.  It will print all of the drive
  54.                     target's worldwide names, port id's, port numbers, and if
  55.                     the controller is in loop mode, the name the device is
  56.                     known by.  A list of all known drive targets which
  57.                     sssseeeessssddddaaaaeeeemmmmoooonnnn is not able to manage is also printed.  This
  58.                     list would include RAIDS (as its not easily possible to
  59.                     distinguish them from JBODS), targets in unsupported
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  71.  
  72.  
  73.  
  74.                     enclosures, and targets in enclosures which do not have
  75.                     working devices in the SES capable slots for the ports
  76.                     reachable by the host running sssseeeessssddddaaaaeeeemmmmoooonnnn.  Targets which
  77.                     are not disk drives are ignored by sssseeeessssddddaaaaeeeemmmmoooonnnn.
  78.  
  79.      ggggeeeettttssssttttaaaattttuuuussss      This command reports status of supported fibre channel
  80.                     drive enclosures.
  81.  
  82.                     For this option, -v (verbose) alone will print a detailed
  83.                     status of all enclosures, -v with specified channel
  84.                     numbers will print a detailed status for the enclosures on
  85.                     the listed channels.  If enclosure arguments are specified
  86.                     then a detailed status will be printed for only those
  87.                     enclosures (and the -v flag is unnecessary).
  88.  
  89.                     If the -v flag is not used, and no arguments are
  90.                     specified, then overall summaries of all fibre channel
  91.                     controllers will be printed. Or only for the specified
  92.                     channels if channel arguments are used.
  93.  
  94.      rrrreeeemmmmoooovvvveeee         This command will allow for physical removal of a drive.
  95.                     I.E. it will spin-down the specified disk drive, and
  96.                     prompt the user for removal, then after all the removes
  97.                     have taken place it will SOP_SCAN the effected
  98.                     controllers.
  99.  
  100.                     Note:  This command issues the spindown command to the
  101.                     drive immediately which locks the drive heads.  However,
  102.                     the drive requires additional time to stop rotating and
  103.                     will still be turning when the exchange prompt is issued.
  104.  
  105.      iiiinnnnsssseeeerrrrtttt         This command will allow for inserting a drive into a
  106.                     specified enclosure. I.E. it will prompt for insertion,
  107.                     and after all the inserts have taken place, it will spin
  108.                     it up the drives, SOP_SCAN the effected controllers, and
  109.                     call iiiiooooccccoooonnnnffffiiiigggg to update the hardware graph.
  110.  
  111.      lllleeeeddddoooonnnn          This command will turn "ON" the indicator "LED" associated
  112.                     with the specified disk device.
  113.  
  114.      lllleeeeddddooooffffffff         This command will turn "OFF" the indicator "LED"
  115.                     associated with the specified disk device.
  116.  
  117.      bbbbyyyyppppaaaassssssss         This command will perform an enclosure bypass to remove
  118.                     the specified disk on the specified port from the fibre
  119.                     channel loop.
  120.  
  121.      uuuunnnnbbbbyyyyppppaaaassssssss       This command will perform an enclosure unbypass to add the
  122.                     specified disk on the specified port onto the fibre
  123.                     channel loop.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  137.  
  138.  
  139.  
  140.      sssslllloooottttbbbbyyyyppppaaaassssssss     This command operates the same as bbbbyyyyppppaaaassssssss except that
  141.                     instead of taking a target argument, it takes an enclosure
  142.                     and slot argument.  This command will work on an enclosure
  143.                     slot which does not have a drive in it.
  144.  
  145.      sssslllloooottttuuuunnnnbbbbyyyyppppaaaassssssss   This command operates the same as uuuunnnnbbbbyyyyppppaaaassssssss except that
  146.                     instead of taking a target argument, it takes an enclosure
  147.                     and slot argument.  This command is useful for cases where
  148.                     the WWN of a target is not yet known (such as after a
  149.                     drive swap).
  150.  
  151.      aaaallllaaaarrrrmmmmoooonnnn        This command will sound the alarm on the specified
  152.                     enclosure.
  153.  
  154.      aaaallllaaaarrrrmmmmooooffffffff       This command will turn off the alarm on the specified
  155.                     enclosure provided that the enclosure is clear of any
  156.                     other hardware conditions which also result in the alarm
  157.                     sounding.
  158.  
  159.      aaaallllaaaarrrrmmmmmmmmuuuutttteeee      This command will mute the enclosure's alarm.  Generally
  160.                     this will result in a periodic reminder tone instead of
  161.                     totally silencing it.
  162.  
  163.  
  164. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  165.      ----cccc _c_h_a_n_n_e_l-_I_D  Use this option to limit a status command to a particular
  166.                     fibre channel controller.
  167.  
  168.      ----eeee _e_n_c_l_o_s_u_r_e-_I_D
  169.                     Use this option to specify a particular enclosure.
  170.                     Enclosures are identified by a 64 bit hex number similar
  171.                     to a world wide name. (Don't forget the 0x prefix on the
  172.                     arguments for this option.)
  173.  
  174.      ----ssss _s_l_o_t-_I_D     Use this option for sssslllloooottttbbbbyyyyppppaaaassssssss and sssslllloooottttuuuunnnnbbbbyyyyppppaaaassssssss to specify
  175.                     the enclosure's drive slot.  Slots are numbered starting
  176.                     from 0.
  177.  
  178.      ----tttt _t_a_r_g_e_t-_I_D   Use this option to direct an action at a particular drive
  179.                     or set of drives.  Targets are identified by their world
  180.                     wide name, a 64 bit hex number unique to each drive.
  181.                     (Don't forget the 0x prefix.)  If the target is operating
  182.                     on a private loop, it is also possible to specify it by
  183.                     its sc* name in /hw/scsi (eg sc4d65l0).
  184.  
  185.  
  186. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  187.      Obtaining the revision level of the instance of sssseeeessssmmmmggggrrrr running locally
  188.  
  189.           sssseeeessssmmmmggggrrrr ggggeeeettttvvvveeeerrrrssssiiiioooonnnn
  190.  
  191.           sample output:
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  203.  
  204.  
  205.  
  206.  
  207.           sesdaemon version 1.0, Thu May 11 18:46:09 PDT 2000
  208.  
  209.  
  210.  
  211.      Obtaining a brief channel status summary:
  212.  
  213.           sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss
  214.  
  215.           sample output:
  216.  
  217.           CHANNEL | DRIVES    POWER    LCC     FANS     TEMP    ALARM
  218.           --------+--------------------------------------------------
  219.               2   |  NONE     NONE     NONE     NONE     NONE    NONE
  220.               3   |   OK      FAIL      OK       OK       OK      ON
  221.               4   |   OK       OK       OK       OK       OK     NONE
  222.  
  223.      The example shows that channel 3 has one or more enclosures reporting a
  224.      power supply fault and an alarm is sounding. Channel 2 shows "NONE" which
  225.      indicates a few possibilities.
  226.  
  227.      o  There are no recognized fibre channel enclosures connect to the
  228.         channel.
  229.      o  There is a communication problem on the channel.
  230.      o  "NONE" can also mean that none of the recognized enclosures support
  231.         that feature.  As on channel 4, the enclosures do not include an
  232.         alarm.
  233.  
  234.      Obtaining a detailed status of an enclosure:
  235.  
  236.           sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss ----eeee 0000xxxx55550000000055550000cccccccc00000000000000000000222200005555cccc
  237.  
  238.           sample output:
  239.      Enclosure ID:  0x50050cc00000205c
  240.        Vendor ID: XYRATEX
  241.        Product ID: SS-1202-FCAL
  242.        FRU's (Inst/Max):  11 of 12 drives
  243.                           2 of 3 power supplies
  244.                           1 of 2 recognized lcc's
  245.        Last successful status poll: Tue May 16 17:19:17 2000
  246.  
  247.  
  248.        +---------------------------+    Slot    Worldwide Name (*=SES)
  249.        | 1/1  | 2/1  | 3/1  | 4/1  |    1/1     0x20000020374bab85
  250.        |  OK  |  OK  |  OK  |  OK  |    2/1     0x20000020374bb5e2
  251.        |      |      |      |      |    3/1     0x20000020374bb504
  252.        +---------------------------+    4/1     0x20000020374b17ee
  253.        | 1/2  | 2/2  | 3/2  | 4/2  |    1/2     0x20000020374baf03
  254.        |  OK  | OUT  |  OK  |  OK  |    2/2     0x0
  255.        |      |      |      |      |    3/2     0x20000020374bafdc
  256.        +---------------------------+    4/2     0x20000020374b194f
  257.        | 1/3  | 2/3  | 3/3  | 4/3  |    1/3     0x20000020374bb280*
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  269.  
  270.  
  271.  
  272.        |  OK  |  OK  |  OK  |  OK  |    2/3     0x20000020374bb007
  273.        |      |      |      |      |    3/3     0x20000020374bafe1
  274.        +---------------------------+    4/3     0x20000020374bb271*
  275.        FAN0  OK     FAN1  OK     FAN2 OUT
  276.        PS0   OK     PS1   OK     PS2  OUT
  277.        TEMP  OK      29 C        ALARM  OK
  278.  
  279.      The example shows that slot 2/2 does not have a drive in it, and both fan
  280.      2 and power supply 2 are not installed.  Also this enclosure either has
  281.      only one fibre channel loop connection or else only one is visible
  282.      (connected) to the host.
  283.  
  284.      Illuminating the LEDs associated with disk 1/1 and 2/1:
  285.  
  286.           sssseeeessssmmmmggggrrrr lllleeeeddddoooonnnn ----tttt 0000xxxx22220000000000000000000022220000333377774444bbbbaaaabbbb88885555 ----tttt 0000xxxx22220000000000000000000022220000333377774444bbbbbbbb5555eeee2222
  287.  
  288.  
  289.  
  290. LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
  291.      Commands which change the enclosure status will not be reflected by
  292.      ggggeeeettttssssttttaaaattttuuuussss until the next status poll executes (or until a ppppoooollllllll command is
  293.      run).
  294.  
  295.      Currently the only supported enclosures are the Xyratex 12 slot, Xyratex
  296.      16 slot, and Clariion 10 slot enclosures.
  297.  
  298.      Not all enclosures will support all commands or types of FRU's.  For
  299.      example, the Xyratex 12 slot enclosure does not support enclosure bypass
  300.      and unbypass.  And the Clariion enclosure does not have an alarm.
  301.  
  302.      The lllleeeeddddoooonnnn and lllleeeeddddooooffffffff commands may indicate differently depending on the
  303.      enclosure's implementation.  For example, the Xyratex 12 will slowly
  304.      blink the activity led when its "on", and leave it lit solidly when
  305.      "off".  Clariion enclosures will solidly indicate on the fault LED.
  306.  
  307.      Removing a drive can send a controller into error recovery mode as it
  308.      tries to find the target and bring it back online.
  309.  
  310.      It may take a while for SOP_SCAN and iiiiooooccccoooonnnnffffiiiigggg to complete depending on
  311.      how large and how busy the SAN is.
  312.  
  313.      When a device is specified by its sc* loop name, the code will find that
  314.      device.  However commands to that device may use alternate paths.
  315.  
  316.      On ppppoooollllllll updates its possible that failed equipment may disappear and no
  317.      longer be shown as failed.  Failed targets can be dropped from the target
  318.      list, but they should still be printed in their enclosure slot by
  319.      ggggeeeettttssssttttaaaattttuuuussss.  Enclosures which are no longer reachable (and their targets)
  320.      may be dropped entirely.  This is due to a configuration update
  321.      assumption that targets which do not respond were intentionally moved.
  322.  
  323.      bbbbyyyyppppaaaassssssss and uuuunnnnbbbbyyyyppppaaaassssssss can fail if the commands can not be issued on the
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  335.  
  336.  
  337.  
  338.      same loop that the specified device's port is on.
  339.  
  340.      If a drive is bypassed so that the system no longer sees an active
  341.      target, and the daemon is restarted, the target may no longer be seen.
  342.      In this situation it will not be possible to issue an unbypass command to
  343.      the target.  Use the sssslllloooottttuuuunnnnbbbbyyyyppppaaaassssssss command instead.
  344.  
  345.      In the event that an enclosure hasnt been heard from during a period
  346.      three times sssseeeessssddddaaaaeeeemmmmnnnn's poll period, getstatus will show OLD for the
  347.      status fields.  If an enclosure has been disconnected, use the ppppoooollllllll
  348.      command to update the configuration and status information.  More
  349.      typically, OLD indicates that there is a communications problem.
  350.      Depending on the nature of the problem, error recovery can hold off the
  351.      sequential polling of other controllers.  Be advised however that OLD
  352.      will NOT be listed if the enclosures for a controller can be reached via
  353.      alternate paths.
  354.  
  355.      In order to run sssseeeessssmmmmggggrrrr under TRIX, the user must have a MAC label of
  356.      dblow and a capability of CAP_PRIV_PORT.
  357.  
  358.  
  359. DDDDIIIIFFFFFFFFEEEERRRREEEENNNNCCCCEEEESSSS FFFFRRRROOOOMMMM FFFFCCCCCCCCLLLLIIII
  360.      Although the sssseeeessssddddaaaaeeeemmmmoooonnnn/sssseeeessssmmmmggggrrrr utilities are designed to be similar in
  361.      look and functionality, there are some important differences.  Here are
  362.      some of these:
  363.  
  364.      Enclosure ID's and target ID's are now 64 bit hex integers.
  365.  
  366.      iiiinnnnsssseeeerrrrtttt now takes an enclosure ID, not a target ID.
  367.  
  368.      An argument id is now required before each one (eg -t) to tell what type
  369.      it is.
  370.  
  371.      Target lists are no longer restricted to an individual controller.
  372.  
  373.      bbbbyyyyppppaaaassssssss and uuuunnnnbbbbyyyyppppaaaassssssss are enclosure commands only.  Loop commands are not
  374.      attempted.
  375.  
  376.  
  377. FFFFIIIILLLLEEEESSSS
  378.      /usr/sbin/sesmgr
  379.  
  380.  
  381. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  382.      ioconfig(1M), scsiha(7), sesdaemon(1M)
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.